Vox-p - guia do usurio

#>
1. Introduo

Fazer o buscador Google funcionar no Dosvox tem sido bastante difcil.
Seguindo outros desenvolvedores que programaram solues alternativas para esse problema, trazemos o Vox-p.

O Vox-p  um aplicativo para Dosvox que usa o motor do Brave Search para pesquisar na Web.
Ele no pretende ser a soluo definitiva, nem pretende ser concorrente com outras solues j existentes.
Ele pretende sim, ser mais uma alternativa, ampliando as possibilidades de escolha dos usurios de Dosvox.

Escolhemos usar o Brave Search por ser um buscador que se apresentou bastante satisfatrio, trazendo bons resultados nos testes de pesquisa e, por ser possvel atravs de sua api, criar uma interface direta dentro do Dosvox.

Este guia mostra como usar o vox-p. Para informaes sobre download e instalao, veja vox-p - guia de instalao.txt.

#>
2. Utilizao

Ao abrir o programa, ser apresentada uma mensagem de boas vindas seguida do identificador de verso.
Surge ento a pergunta: "Vox-p, o que deseja buscar"?
Digite o que deseja buscar e pressione enter.
Teclando Esc ou deixando o campo de pesquisa vazio, o programa  fechado.
Ser mostrado na tela o resultado da busca.

So mostrados 20 tens por pgina, com um limite de at 10 pginas por pesquisa.

Na primeira pgina, a lista pode ser maior que 20, porque o vox-p tentar aproveitar alguns contedos adicionais que costumam aparecer na pgina 1.

Observe porem o seguinte:
1. A lista de resultados pode ser menor que 20.
Esse comportamento  normal, e  previsto na documentao da api.
2. Nem sempre havero 10 pginas por resultado.

O Vox-p busca enquanto no receber contedo vazio.
 Quando o contedo vier vazio, o limite  automaticamente definido para a ltima pgina com contedo.

#>
2.1. Opes para a lista de resultados

Para selecionar um resultado, use as setas para cima e para baixo.
A tecla f1 mostra a ajuda.
A tecla enter confirma a seleo de um resultado da lista.
A tecla tab avana uma pgina.
A tecla backspace volta uma pgina.
A tecla Esc fecha a lista de resultados e permite fazer uma nova pesquisa.

#>
2.2. Opes para um resultado

Ao teclar enter sobre um resultado selecionado, ficam disponveis as seguintes opes:
w:abre o resultado selecionado com o Webvox.
Enter: Abre o resultado selecionado com o navegador padro do Windows.
CTRL+Enter: Abre o resultado selecionado com qualquer outro programa ou navegador que voc tenha instalado.
Para isso, basta informar o caminho completo ou o nome do executvel, por exemplo:
digitando  chrome, caso voc tenha o google chrome instalado, instrui o chrome a abrir o site referente ao resultado selecionado no vox-p.
r: fala o resumo do resultado selecionado.
l: fala o link do site referente ao resultado selecionado.
t: fala o ttulo do resultado selecionado.
f: fala a fonte do resultado selecionado.
CTRL+C: Copia resumo, fonte, ttulo e link do resultado selecionado para a rea de transferncia.
Ctrl+r: copia somente o resumo.
CTRL+l: copia somente o link.
CTRL+t: copia somente o ttulo.
CTRL+F: copia somente a fonte.
Shift+r: permite ler o resumo por caracter.
Use as setas esquerda e direita para ler.
Escape ou enter retiram o campo de leitura.
Shift+f: permite ler a fonte por caracter.
Shift+l: permite ler o link por caracter.
Shift+t: permite ler o ttulo por caracter.
Esc: volta  lista de resultados.

#>
3. Opes da linha de comando

O vox-p pode receber dois parmetros na linha de comando.
Eles no so obrigatrios e, normalmente, chamamos o vox-p sem parmetros.

#>
3.1. di (diretrio de inicializao).

Para informar em qual diretrio o vox-p deve iniciar, voc deve cham-lo assim:
vox-p di=c:\programas\vox-p

Neste exemplo, o vox-p foi descompactado na pasta c:\programas, onde foi criada automaticamente a pasta vox-p.
Isso  muito til quando voc usa o vox-p em um local diferente de \winvox e da raiz do disco c.

Quando o vox-p  chamado sem o parmetro "di", o comportamento  o seguinte:
Primeiro, verifica se a pasta vox-p existe dentro de c:\winvox.
Se no existir, verifica ento se existe na raiz do disco c.
Se no encontrar, devolve um erro de inicializao e encerra.

Voc pode, por exemplo, criar um arquivo .bat, que chama o vox-p, passando o parmetro "di" e o diretrio de inicializao como argumento.
Veja mais sobre isso no arquivo vox-p - guia de instalao.txt.

#>
3.2 . db (ativar debug).

Em caso de erro,  til fazer com que o vox-p gere um arquivo de log, mostrando o dilogo entre ele e o servidor.

Mesmo sem ativar o debug, quando h algum erro na requisio,  gerado na pasta vox-p\logs, um arquivo mostrando a mensagem de erro que o servidor devolveu.

Ativando o debug, todo o trfego http  gravado.

Para executar o vox-p com o debug ativado, voc pode cham-lo assim:
vox-p db=1

Se o parmetro "db" no for especificado, assume o valor padro que  0, ou seja, debug desativado.

----
Programa e manual escritos por Fabiano Ferreira.

Volta Redonda, 12/06/2026
